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A TOOL FOR SOFTWARE DIAGNOSIS DIVIDED ACROSS 
MULTIPLE PROCESSORS 

BACKGROUND OF THE INVENTION 
This application claims priority of U.S. Provisional 
Patent Application No. 60/005,110, filed September 1, 1995, 
entitled "A Tool for Software Diagnosis Divided Across 
Multiple Processors," with Attorney Docket No. 014274-000200. 

This invention relates to software development and 
debugging environments. In particular, the invention relates 
to development and debugging environments wherein the software 
to be analyzed resides in a processor system distinct from but 
connected to another processor system running the debugging 
software's interface with the user. 

In the development of software, the use of a 
debugging program (or "debugger") is not uncommon to analyze 
software to be developed or known to have a bug. This is the 
test software. One of the primary functions of such a 
debugger is to allow the user — typically a development or 
diagnostics engineer — to view the memory as modified by the 
execution of the test software. 

As C and C++ are the programming languages currently 
enjoying the greatest acceptance among programmers in the art, 
this invention is described in C and C++. Of course, any 
programming language capable of the concepts discussed herein 
can realize this invention and its benefits. 

The problems of debugging software are amplified in 
certain respects when the processor system on which the test 
software resides (the "target system" or "target") has 
insufficient resources to support a debugging environment. 
The usual critical resource is memory. In these situations, a 
substantial portion of the debugging environment can be 
displaced to a separate remote system, the "host system" or 
"host," and the target and host systems communicate by a 
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communications link. The software on the target communicating 
over the link is the debugging agent, and that portion 
residing on the host is the debugging server. 

The resolution of the limited memory problem by 
displacement results in other problems: communicating using 
the limited bandwidth of the communications link, for example. 
The bandwidth limitation is particularly acute when mass or 
high-speed data throughput is not the primary function of what 
becomes the communications link for development or debugging 
purposes or when complex and/or large data structures such as 
linked lists or tables must be retrieved by the debugging 
server from the debugging agent. In prior art systems, a 
significant portion of the bandwidth expended on retrieval of 
data from the target is simply the transmission of data 
requests from the server to the agent. For example, the 
retrieval of the linked list linked_data_list of the following 
data structure 



structure datum 

"20 { ~ ~" 

int * f irst_element; 
int second_element ; 
datum *datum_po inter ; 
} *linked_data_list; 

25 

requires first requesting and retrieving the address of the 
datum structure at the head of the list (*linked_data_list) , 
then requesting and retrieving sizeof (structure datum) bytes 
from that address, then requesting and retrieving 

30 sizeof (structure datum) bytes from 

* (linked_data_list->datura_pointer) , and so on. Any reduction 
in the amount of data transferred as data requests or the 
amount of data transferred in response to data requests would 
be a relief from the constraints of the narrow-channel 

35 communications link. 

Another prior art method for retrieving 
linke<4_data_list would be to have a special service, 
GET__linked_data_list, built into the debugging agent. Thus, 
when the debugging server wants to look at linked_data_list , 

40 it simply invokes the GET_linked_data_list service. However, 
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given the variety of variable types typically found in an 
operating system and the additional number in the attendant 
application code, such a scheme does not bode well for 
minimizing the footprint of the debugging agent on the target 
5 memory. The alternative of restricting the freedom of the 
programmers in declaring variable types is not attractive 
either. 

Even with displacement, the debugging agent can 
still consume a not insignificant amount of the memory of the 
10 target computer. An enduring design struggle is to provide 

sufficient services in the debugging agent to create a useful 
and even capability-laden agent while attempting to keep 
memory consumption to a minimum. A part of this struggle is 
whether to include services which are not frequently used but 
15 are extremely helpful if present when needed. 

The uploading of data to the host computer can 
consume a major percentage of the available bandwidth on the 
communications link. Typically, the debugging server lacks 

the intelligence to ask whether the data being transferred 

20 duplicative or otherwise unnecessary. Accordingly, there is a 
need for a debugging server which screens requests for data of 
the target and thereby reduces the amount of traffic on the 
communications link. There is also a need for a debugging 
server to screen data destined for the target and thereby 
25 reduce the amount of traffic on the communications link. 

Many device-controlling systems provide only the 
communications interfaces necessary to control the device or 
devices of interest. One justification for so limiting the 
interfaces is cost. However, in a target/host development 
30 configuration as described above, at least one communications 
interface is given over to supporting the target/host 
configuration. Accordingly, the reallocation of 
communications interfaces disturbs the system under test, and 
the test scenario loses a certain amount of verisimilitude or 
35 verifiability. It would be preferable to connect all the 

controlled devices as well as the host system to the target 
machine — even in configurations where each of N controlled 
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devices requires a respective one of N total communications 
interfaces . 

Some systems do not incorporate any means for 
communicating with the external world during normal operation. 
5 Nonetheless, a developer would like to debug in situ these and 
other similarly situated systems (e.g., systems where 
interrupting (any of) the fully allocated communications 
interface (s) is not preferable). A technique to enable the 
developer to debug these severely resource-limited systems is 
10 needed. 

Prior art exists to establish a communcation path to 
a resource-constrained system as described. These devices 
include the NetRom product available from Applied Microsystems 
Corporation of Redmond^ Washington. Typical of its class, the 
15 NetRom product connects into a ROM socket on the target side 
and provides a standard ethernet or serial interface to the 
host. However, to knowledge, such devices have been used 
primarily to replace programmed ROMs in unstable systems, 
Reprogramming the software available via a NetROM is easier 
20 than reprogramming an actual ROM. 

Accordingly, an object of this invention is to 
create a debugging environment which has a smaller footprint 
in the memory of target systems. 

Another object of the invention is to minimize the 
25 size of the debugging agent in the target memory while still 
offering all of the capabilities a software developer expects 
from a full-featured debugging environment. 

An object of the invention is the addition of 
intelligence to the host-side software in order to reduce the 
3 0 consumption of available bandwidth by reducing both the number 
and size of target/host transactions. 

Another goal of the invention is the addition of 
intelligence to the host-side software in order to obviate 
certain target-side intelligence and thus free the memory the 
35 target-side intelligence would consume. 

Yet another goal of the invention is, in a 
target/host development environment, to connect all controlled 
devices as well as the host system to the target machine. 
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particularly when each of N controlled devices requires a 
respective one of only N available communications interfaces. 

Another object of the invention is, in a target/host 
development environment, to connect to the host a target 
machine with no conventional communications interfaces 
available. 

Still other objects and goals of the present 
invention will be obvious to a person of ordinary skill in the 
art on reading the background above and the disclosure below. 



SUMMARY OF THE INVENTION 
The present invention is apparatus and methods 
coupling a first, target processor to a second, host 
processor. The target processor runs a debugging agent while 
15 the host processor runs a debugging server application which 
interacts with its counterpart, the debugging agent. The two 
processors are coupled by a communications link. 

In one embodiment, to retrieve data from the memory 
of the target processor to the memory of the host, the host 
20 processor generates a program in an interpreted language to 
read the data from the memory of the target processor and 
communicates that program to the target processor. The target 
processor interprets the program, reading the data and 
communicating it over the communications link to the host 
25 processor. The program and/or the data communicated can be 
compressed for transmission and decompressed on reception. 
The advantages of the apparatus and method include reduced 
traffic on the limited bandwidth of the communications link 
and the avoidance of dedicated target-based services of 
30 limited use. 

In another embodiment, the application to be 
developed and the debugging agent share libraries and provide 
debugging services from the shared libraries. Application and 
debugging code are partially or fully linked together, user 
35 demands are satisfied by executing code in the core common to 
the application and the debugging agent. In a preferred 
embodiment, a copy of the core is placed on the target machine 
while a copy of the symbol table is placed on the host. The 
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debugging agent is then scalable beyond the services in the 
core by default. The amount of redundancy between the 
debugging agent and the application is at the discretion of 
the application developer. The developer controls the impact 
5 of the debugging agent on target memory, 

In another embodiment, in order to debug 
applications, the program text of the debugging agent is 
supplemented to provide debugging services as the user demands 
them. Scalable debugging agents fundamentally extend the 
10 range of scalability beyond that of traditional target/monitor 
approaches . 

In one embodiment, the debugging target and server 
cooperate to read memory of the target computer into the 
memory of the host computer coupled to a user input device. 

15 When a user (e.g., a user program displaying a thread of 

execution by continually displaying the relevant stack) issues 
first and second commands to read the memory of the target 
computer, the host computer determines the time differential 
between the sequential commands and reads thp me^mniry ir , 

20 response to the second command only if the time differential 
is greater than a predetermined value. 

In another embodiment, the host computer is again 
coupled to a user input device. When a user directs a 
modification of the memory of the target computer, the host 

25 computer generates a script for moving data extant in the 

memory of the target computer and/or copying over data to the 
memory of the target computer so as to recreate the 
modification specified by the user. Where the size of the 
modification is small compared to the size of the total data, 

30 communicating the changes rather than the total modified data 
conserves the limited bandwidth of the communication means 
coupling the two computers together. 

In yet another embodiment, the target processor is 
adapted for coupling to and controlling an external device. 

3 5 The target processor has a number of communications channels 
needed to operate in its final configuration, including one 
which controls the external device. The host processor uses 
this one communications channel for coupling to the target 
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device and uses one of its communications channels to couple 
the target processor to the external device. 

In a further embodiment, the invention couples the 
host computer and the target processor at the debugging 
5 target/server level by means of an in-circuit emulator. One 
such in-circuit emulator is a ROM emulator. 

BRIEF DESCRIPTION OF THE DRAWINGS 
Figure 1 illustrated a cross-platform environment 
10 according to a preferred embodiment; 

Figure 2 illustrates a host/target system with a 
host-resident caches- 
Figure 3 is an abstract diagram of a host/target 
system and their respective memories; 
15 Figure 4 illustrates the levels of software 

supporting an embodiment of a virtual I/O channel; 

Figure 5 illustrates a target and host connected by 
remote communications; and 

Figure 6 illustrates the architecture of the target 

2 0 debugging server. 



DESCRIPTION OF THE PREFERRED EMBODIMENT 

TABLE OF CONTENTS 

25 

1 . Overview j 

2. Gophers g 

30 3, Debuaainq Services on Demand 16 

4. Shared Run-Time Debuqcring Services 20 

5. Quantized Streaming Differential Cache 21 

6. Host-Ba sed Target Memory Management 24 

7. Virtual I/O 25 

40 8. In-circuit Emulation 27 

9. World-Wide Access 28 

WHAT IS CLAIMED IS 3q 



45 



1. Overview 

The processor system most likely to benefit from the 
invention disclosed herein is the cross-platform for software 
development or software debugging. Figure 1 illustrates a 8 
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cross-platform environment 100 incorporating the invention. 
In such a cross-platform environment, the debugging software 
is divided in two. The first portion of the debugging 
software, the debugging agent lio, resides on a target 
5 computer 120 along with the software 130 undergoing 

development or debugging. The second portion of the debugging 
software, the debugging server 140, resides on a host computer 
150 which provides an interface (here Tornado™ Launcher 160) 
to the developing or debugging user. The target and host 
10 computers are connected by means of a communications link 170 
which can be serial, parallel, LAN, WAN, or any other form of 
I/O or hardware-assisted emulator or romulator. 

The preferred operating system for the target is the 
VxWorks™ operating system 130b, available from the assignee of 
15 this patent application. Communications between the host and 
target are by means of the ONC RFC protocol, which can be 
implemented on virtually any transport layer. The host and 
target respectively support the following services (described 
from the host's vantage): 

20 

•ping a target 

•connect to the debugging agent 
'disconnect from the debugging agent 
•set the debugging agent mode 
25 'read a target memory region 

•write a memory block to the target 

•fill a target memory block with a pattern 

•move a target memory block 

•compute the checksum value of a target memory 
30 region 

•turn protection on or off for a target memory 
region 

•update the target instruction cache 
•search for a pattern in the target memory 
3 5 -create a context on the target 

•destroy a context on the target 
•suspend a context on the target 
•resume a context suspended on the target 
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•get values from target registers 

•set values of target registers 

•write data to a target virtual I/O channel 

•add an eventpoint on the target 

•delete an eventpoint on the target 

•get an event from the target 

•continue a context suspended on the target 
•single step a context on the target 
•call a function on the target 
•call a function in the agent 
•evaluate a gopher string on the target 
•check if an event is pending on the target 
•clear an event pending on the target 
•call a service on the target 

•free the memory used by the returned structure 
Each of these services is described in the Tornado~ API Guide, 
available from the assignee of the instant patent application.' 

2 . Gophers 

In order to reduce traffic on the communications 
link between the target and host, a system uses a first 
embodiment of the invention: Gophers. Gophers are interpreted 
programs for efficiently retrieving data from the memory of 
the target to the memory of the host. Gophers are 
particularly useful when the data to be retrieved has a 
complex structure. 

In a preferred embodiment, the Gopher language has 
only one state indicator, a programmable variable referred to 
as the "pointer." Also, the Gopher language has only one l/o 
device, an abstract "tape." All Gopher actions are 
interpreted relative to the value of the pointer, and all 
output is via the tape. 

The Gopher language also includes the following 
syntactic elements: 

Table I: 



Gopher Language Syntactic Elements 
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Directive 


Action 


n 


Set the pointer to the integer value n 




Increment or decrement the pointer by the 
integer value n 




Write the pointer to the tape 


* 


Replace the pointer with the value pointed to 
by the pointer 




Write the value pointed to by the pointer to 
the tape, and advance the pointer. "B," "W," 
and "L" indicate that the size of the value 
is 8, 16 or 32 bits, respectively. The 
Dointer is adv;^!^^^^ hv "hh** ei'7o m-F -i-Kck ^r-kii^A 
written. ("L" is the default.) 


$ 


Write the (zero-terminated) string to which 
the pointer points to the tape. 


{ - - . } 


Create and use a local copy of the pointer to 
repeatedly evaluate the Gopher string between 
the curly braces until that pointer is zero. 
Upon completion, the local copy of the 
pointer is destroyed and the original is 
unchanged. 


< . * - > 


Create and use a local copy of the pointer to 
evaluate the Gopher string between the angle 
braces once. Upon completion, the local copy 
of the pointer is destroyed and the original 
is unchanged. 


(n . . . ) 


Create and use a local copy of the pointer 
and evaluate the Gopher string inside the 
parentheses n times. 



A Gopher can be used to retrieve, for example, the 
linked list ifnet containing most of the information for 
network interfaces in the preferred target operating system. 
15 The structure ifnet is declared as follows: 



SOOCtD: <W0 8S0920aA2 I > 



BNS oaoe 12 



wo 98/09268 



PCT/US97/14842 



11 



10 



struct ifnet { 
char*if_name; 
shortif_unit; 
shortif_intu; 
shortif_f lags ; 
shortif _t imer ; 
int if metric; 



/* name, e.g. ^ ^en" or ^Uo" */ 
/* sub-unit for lower level driver */ 
/* maximum transmission unit */ 
/* up/down, broadcast, etc. */ 
/* time 'til if_watchdog called */ 
_ /* routing metric (external only) */ 

structifadder *if_addrlist ; /* linked list of addresses per 

if */ 

/* Some members of this structure have been omitted here for 
simplicity. */ 



/* generic interface statistics */ 
15 int if_ipackets; /* packets received on interface */ 

int if_errors; /* input errors on interface */ 

int if_opackets; /* packets sent on interface */ 

if_oerrors; /* output errors on interface ★/ 

int if_collisions; /* collisions on cama interfaces */ 

20 /* end statistics */ ' 
structifnet *if_next; 
*ifnet_ptr; 

} 

An algorithm to traverse the ifnet list might appear 
25 as follows: 

p = ifnet; 

while (p != NULL) 

{ 

print p; 
30 p = p->if next; 

} 

and could be implemented at the host-target interface as a 
target-implemented service or by constructing a command file 
35 or application which repeatedly uses the target memory read 
service. The equivalent Gopher, however, for the algorithm 



ifnet { ! + 84 * } 

40 

This Gopher program is deconstructed as follows: 
ifnet is the integer address of the ifnet pointer, which can 
be obtained from the symbol table by means well-known in the 
art or by querying the debugging server 14 0 regarding symbol 
45 table 180. <ifnet> sets the value of the Gopher pointer. The 
left brace creates a local copy of the pointer and starts a 
Gopher loop. The Gopher interpreter will execute the 
subprogram "1 +84 *" until the local copy of the pointer is 
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not NULL (zero) when the right curly brace is reached. The 
syntactic element ! writes the value of the (local) pointer to 
the output tape, and "+84" then increments the (local) 
pointer. The "*" expression causes the (local) pointer to be 
5 replaced by the quantity to which the (local) pointer 

currently points. A link is thus followed. The delimits 
the end of the loop, which is terminated when the address to 
which the (local) pointer currently points is NULL. 

In all Gopher expressions using matching delimiters 

10 (i.e., "{ , . . }," "< . . . >" and «•(... )") the Gopher 
evaluator saves unchanged the pointer in effect outside the 
delimiters and creates and uses another pointer for use during 
the execution of the delimited expression. The evaluator 
restores the outside pointer when the closing delimiter is 

15 executed. While no code follows the closing delimiter in this 
example, there may, of course, be occasions when such code 
will exist. 

Also, all writes are terminated by white space. 
This allows the contents of the tape to be processed by a 
20 subsequent filter having no additional knowledge of the 
internal characteristics of the data on the tape. 

Note that Gophers have no symbolic capacity and do 
not understand the layout of structures. The "+84" expression 
was determined from inspecting the si2e of the elements 
25 constituting the if net data structure. This is a cost of the 
language independence of Gophers. Advantages include minimal 
syntactic elements and compactness. 

The above example returns a list of network 
interface descriptors. A more sophisticated Gopher can 
30 extract desired fields from each of those data structures. 

The fields of interest in the ifnet data structure 
are deemed to be the name of the interface, the sub-unit for 
the lower-level driver, the maximum transmission unit, the 
flags, the routing metric and the five packet-statistics, 
35 respectively, the if_name, if_unit, if_mtu, if_flags, 

if_metric and if_ipackets through if_collisions members. 

With the Gopher's pointer pointing to the first byte 
of an ifnet data structure, it also points to the address of 
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the string naming the interface. A Gopher program string to 
dereference the pointer and write the string addressed 
follows : 

5 <*$> 

The left angle bracket introduces a subcontext which saves the 
value of the outer pointer. After execution of the ">," the 
pointer still points to the top of the data structure, despite 

10 the dereferencing and advancement of the local pointer caused 
by the pointer-replacement and string-write actions. 

To fetch the next four fields of interest, with the 
pointer still pointing to the if_name field, the following 
Gopher program string advances the pointer over the four bytes 

15 of the if_name pointer ("+4") and then writes the value 
pointed to by the now-advanced pointer ("@") : 

+4 @w @w @w +2 @ 

20 Because if_unit, if_mtu and if_flags are shorts, the value 
write actions are modified with "w." The Gopher program 
string "+2 §" advances the pointer over the watchdog timer 
element and writes the external metric, a four-byte quantity. 

The packet statistics are consecutive within the 

2 5 data structure and the following program string suffices to 
retrieve them: 

+48 @@@@@ 

Thus, the entire Gopher program to retrieve the ten fields of 
30 interest is: 

<*$> +4 ew @w @w +2 @ +48 §@@@§ 

Assuming one byte per character in the Gopher 
35 language, the above program consumes only 32 bytes — 24 bytes 
if the unnecessary white spaces inserted for human form 
factors are removed. Only one remote procedure call to 
execute this 24-byte Gopher program is necessary to retrieve 
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the desired data, and only the 30+ bytes actually desired are 
transferred. 

By comparison, in order to limit the number of RPCs, 
the prior art can read large blocks of data of, say, 
5 sizeof (struct if net) bytes or more. Eighty-four bytes are 
transferred when only 30 bytes are desired, and some 
extraneous number of bytes from the large blocks will be 
transferred as well. Also, the number of RPCs increases as 
large blocks are read as necessary to retrieve the 
10 NULL- terminated name of the interface, and the number of 
extraneous bytes transferred also increases. 

On the other hand, in order to limit the number of 
bytes of data transferred in response to requests, the prior 
art can execute a series of RPCs, one for each non-contiguous 
15 block of if net data structure members desired. 

The superiority of Gophers is highlighted when the 
retrieval of the above 30+ bytes from each of a number of 
linked if net structures is considered. For N such structures, 
the prior art RPCs increase by a factor of N, and the 
extraneous data transferred increases by the same factor. In 
starkest contrast, the Gopher program increases by a mere one 
byte from 



20 



25 



30 



Ijfnet < <*$> +4 @w @w @w +2 @ +48 @@@@@ > 



to 



ifnet { <*$> +4 @w @w @w +2 @ +48 @@@@@ * } 



Further, with Gophers, the number of RPCs remains at 
the lowest number possible: one. The significance of this 
cannot be overstated. As a person of ordinary skill in the 
art will appreciate, different levels of the communications 
35 standard supporting the remote procedure calls (e.g., the 
International Standards Organization ("ISO") Open System 
Interconnection Reference Model ("OSI")) impose overhead, and 
the bandwidth which the cumulative overhead consumes can be 



>JSDOCtO: <W0 9S092CBA2 I > 



8NS oaae 16 



wo 98/09208 PCT/US97/14842 



15 



20 



25 



30 



35 



15 



truly large. An ability to keep the number of RPCs to the 
absolute minimum is necessary to minimiEe bandwidth 
consumption. 

The prior art can minimize the number of RPCs (and 
5 thus the bandwidth consumed in sending data requests) , or it 
can minimize the amount of data requested (and thus the 
bandwidth consumed in sending data back), but the prior art 
does not minimize both the number of RPCs and the amount of 
data transferred in response to those RPCs. With its' ability 
10 to not merely reduce but truly minimize the consumption of 
bandwidth, Gophers represent a clear and major improvement 
over the known art. 

The debugging agent includes an interpreter for the 
Gopher language. Execution time of the interpreted Gopher is 
greater than that of a compiled and linked Gopher would be but 
still represents only a very small fraction of the overall 
transfer time. The Gopher interpreter itself is very small. 
In fact, the Gopher interpreter available from the assignee of 
this patent application is smaller than the amount of the 
memory that would have been required by target routines to 
gather the data of only the basic system objects. 

A compression-decompression scheme can reduce still 
further the bandwidth which the transfer of a Gopher program 
or of the data in response to the Gopher program consumes. 
If, for example, the linked list in interest was a list of 
buffers known to be mostly zeroes, a compression-decompression 
scheme initiated either by the server or the agent and 
communicated to the other would still further reduce the load 
on the communications link. 

The Gopher language is compact to reduce 
communication overhead and is accessible at higher level 
interfaces within the development environment. 

In one embodiment, some or all Gophers are pre- 
generated based on the information available from the symbol 
table regarding the data items of interest. Thus, when a user 
directs the retrieval of a particular data structure, the 
server need only recall and transmit the pre-generated Gopher 
produced in anticipation of that direction. 
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3 . Debugqinq Services on Demand 

With the debugging environment divided between the 
agent on the target and the server on the host computer, still 
further reductions in the size of the debug environment in the 
5 target memory are nonetheless desirable. Accordingly, this 
invention- provides a scalable debugging agent. 

The debugging server 140 has the capability of 
incrementally loading object modules into the target system 
120. To achieve this end, the debugging server 140 uses the 

10 symbol tables contained in every object module to build a 
system-wide symbol table of functions and variable names 
loaded in the target system 12 0. The debugging server 14 0 
adds names from system and application modules 130 alike to 
the system symbol table. Indeed, the debugging server adds 

15 names from the debugging agent 110 itself to the system symbol 
table. 

Fig. 6 illustrates the architecture of the target 
debugging server 14 0. As shown in Fig. 6, the debugging 
_ „ .server_ 140„maintains.„a_copy_610 „of „the_debugging„agent _.ll0_,on. 

20 the host (or, at least, a copy of the symbol table of the 

agent) • This copy 610 allows the debugging server 140 to read 
and analyze the agent 110 's core file to determine what 
symbols are currently available (resolved) in the agent core. 
Without a single upload, the debugging server 140 is 

2 5 "bootstrapped" with the core information. The debugging 
server 14 0 can immediately execute user commands entered 
through a shell 160 and can perforin other functions — 
constrained only by what services have been linked into the 
core . 

30 Correspondingly, the host software 160 will 

typically include a shell ISOd or 160e (with underlying 
hardware, not shown) or other mechanism for communicating with 
the user. The host accepts commands on this user input device 
from the user. (A device for user input is most typically a 

35 keyboard or mouse. However, a disk, tape or other medium file 
containing commands previously stored by the user can also be 
a device for user input.) 
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Some of these commands the software 160 can satisfy 
directly; others may require supplemental information or 
service from the debugging server 140. Still other commands 
may require information or services which only the agent lio 
can provide. For these commands requiring information or 
services from the agent lio, the debugging server 14 0 breaks 
the user command (as relayed by the software 160) into the 
necessary transactions with the debugging agent 110. 

Before the debugging server 14 0 requests a service 
of the debugging agent 110, the debugging server 140 checks 
the host-resident copy 610 of the debugging agent core to 
determine whether the symbol (s) necessary to provide the 
service are resolved in the debugging agent no. 

If the symbols which provide the desired 
functionality are resolved, then the debugging server 140 can 
simply request (e.g., via RPC) that the debugging agent no 
provide the service. where the symbols providing the 
requested service are not resolved in the agent 110, the 
debugging server 140 reads a, memory device (npt^ s^^^ _ 
retrieve the object module containing the text, data, bss or 
literal sections (depending on the unresolved symbols present 
and the format of the object module) to which the unresolved 
symbols refer. 

In one embodiment, the host 140 then relinks the 
25 debugging agent image on the host 150 to include the new 

sections, resolving the symbols of interest, and produces a 
list of differences between the old agent image and the new 
agent image. Using the differences list, the debugging server 
140 then directs the debugging agent 110 through a series of 
target memory modifications (memory moves, writes, etc.) to 
reproduce in the target memory the re-linked debugging agent 
core on the host. 

In an alternative embodiment, after reading the 
memory device to retrieve the sections to which the unresolved 
symbols refer, the debugging server 14 0 directs the debugging 
agent no to accept the sections and relink itself. This 
second embodiment is less preferable in that it requires a 
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larger debugging agent 110 with sufficient intelligence to 
relink itself. 

The result of both of the foregoing embodiments is a 
debugging agent 110 with the symbols supporting the requested 
5 service resolved. The debugging server 140 then directs the 
debugging agent 110 to perform the desired service, thereby 
providing the information or service which the host software 
160 requires and performing, directly or indirectly, the 
user's command. 

10 In a preferred embodiment, the debugging server can 

direct the agent to discard the newly loaded code after use. 

A debugging agent that is scalable allows for an 
agent equipped to handle one environment, say, a production 
environment, to be extended when necessary to support another 

15 environment, say, a development environment or an in-the-field 
debugging environment. A scalable debugging agent is equipped 
initially with an optimal subset of the set of all services 
which it could offer on a target of substantially unlimited 
resources, and the subset is extendable on demand to offer any 

20 of the full set of services. In a preferred embodiment, 
scaling of the agent is automatic, occurring in a manner 
transparent to the user. 

The primary services which a scalable debugging 
agent 110 offers are target memory write and target service 

25 calls. These primary initial services are sufficient to 
support the corresponding server 140 on the host. 

As mentioned above, a program 160 with a user 
interface for debugging the target software resides on the 
host. In the preferred embodiment, this program 160 is the 

30 remote source-level CrossWind^ debugger 160d available from 
the assignee of this patent application. The CrossWind™ 
debugger 160d extends the GNU Source-Level Debugger (GDB) with 
a graphical user interface and with a comprehensive Tel 
scripting interface which allows developers to create 

35 sophisticated debugger macros and CrossWind"^ extensions. The 
CrossWind™ debugger 160d permits a user to spawn and debug 
tasks on the target. The user can also debug already-running 
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tasks spawned with a runtime shell. Debugging includes 
setting system and task-level breakpoints. 

The memory device to which the host debugger 160d 
refers for the original debugging agent core file or for the 
additional sections can be a conventional host-based RAM, ROM, 
disk, user input device or other host-based memory device. 
Alternatively, the host debugger program 160d can query the 
agent lio itself for this information. (The agent no is 
typically loaded from ROM.) Accordingly, the agent 110 
contains the origins of itself and its scaling object modules. 
Querying the agent no allows use of agents no other than 
those provided by the assignee of the patent application 
because no assumptions are made about the construction of an 
agent 110. The host explicitly asks the agent 110 for 
15 information as necessary. 

As a precautionary measure, the host may request the 
agent 110 to provide a checksum of its text region. The host 
then compares this checksum against a checksum of the text 
region of the core file specified by the agent 110. One 
reason that the two checksums might differ is that the core 
file on the host may have been updated independently of and 
after the writing of the agent to the target ROM. 

The types of services which can be thus 
incrementally loaded are limited only by the services which 
must initially reside in the target in order to enable the 
loader and user interface in the server. The following agent 
services are good candidates for dynamically scaling into the 
agent iio: Serial line testing, breakpoint support, context 
(task) control, event support, host exception notification, 
external context function calls, gophers, memory services, 
(other than write and move) register access and virtual I/O 
support. 

Of course, if dynamic scaling as described above is 
applied to even the most mundane agent services, the size of 
the debugging agent lio in the target memory is guaranteed to 
always be at a minimum, on the user's first invocation of a 
particular command, the debugging server 140 can download the 
supporting code — transparently to the user — to the agent 
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110. No (or minimal) services will exist in the agent 110 
which the user did not actively need and thus no (or minimal) 
excess code will exist in the target memory. The debugging 
agent 110 is essentially customized for the particular 
5 debugging session. 

In order to avoid the target llO's reserving the 
maximum amount of memory a scalable agent may ever need just 
in case the agent grows to that size, the invention includes a 
method for sharing memory between the debugging agent and the 
10 operating system software or other application of the target. 
In a less complicated form, the debugging agent is allowed to 
grow, consuming more and more memory. In a more sophisticated 
form, the debugging agent both grows and shrinks, consuming 
and releasing memory in the process. 

15 

4- Shared Run-Time Debuaqina Services 

The invention includes another method for reducing 
the size of the debugging agent 110 in the memory of the 
target computer 120. Typically, application code 130 relies 

20 upon a library of functions provided with the application 

development environment. Among other things, these standard 
libraries obviate the need for the program developer to 
program and re-program commonly used routines, and they can 
make the interfaces to operating system services more 

25 programmer-friendly. 

The conventional wisdom is that a debugging agent 
110 (for that matter, debugging tools in general) and the 
program 130 to be debugged should not share libraries. There 
may be an interaction between the agent 110 and the program 

30 130 which creates or, more subtly, hides a problem. However, 
these standard libraries can be very large and duplicating 
them for both the agent 110 and the application 130 makes the 
amount of target memory occupied even greater. Accordingly, 
sharing standard libraries between agent and application can 

35 offer a material benefit in conserving target memory. 

In one embodiment, this invention provides a simple 
mechanism to determine if code is to be shared or not. When 
incrementally adding new application code to the target system 
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120, the host-based loader 62 0 merely references the most 
recently defined symbol for the purpose of symbol resolution. 
Duplicate entries in the system symbol table are not rejected. 
In this way, at his discretion, a user may download redundant 
copies of services provided by the agent in the core image or 
may link against the resident services. 

Such an approach need not be limited to the entirety 
of a library. Even the sharing of a single routine within a 
resident library can be avoided. Consider the situation where 
both the agent and an application need functions f () and g() 
which exist in a library which could be shared. The 
application can be linked such that function f() comes from 
the library shared with the agent. Function g() can be 
supplied in the application's source code, and incrementally 
downloaded to the system before the remaining body of 
application code is incrementally downloaded. The 
preferential reference of the loader to the more recent 
definition of the function g() will resolve the reference to 
the unshared definition of g() . m prior art, such control 
over the degree of shared runtime code has not been possible. 

When the scalability of the debugging agent lio is 
combined with shared libraries, the advantages are geometric. 

5' Quantized Streami ng Diff e rential nan ho 

In responding to user requests, the debugging server 
classically turns to the debugging agent, asking for data to 
be uploaded. The debugging server then uses the uploaded data 
to produce a response to the user. If the user repeatedly 
requests the same data, a conventional server will repeatedly 
request the data of the agent and accordingly prepare the 
responses to the user. 

According to the present invention, the copies of 
portions of the target memory which have been uploaded and now 
reside in the memory of the host can be likened to a data 
cache, with the original data residing on the target computer. 

Further, as with all data caches, the question 
arises: When are reads satisfied from the cache and when must 
the read be satisfied from the original data? Conventional 
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debugging servers ignore the caching potentials and always 
satisfy data read requests from the original data on the 
target. The proffered justification is the need to have the 
latest information from the target. However, most of the 
reads performed to satisfy these requests are not performed in 
a locking mode wherein the accuracy of the data being read is 
assured by locking out any code which could modify the data 
during the reading. Even with reads performed with locking, 
there is no guarantee that the modifying code will not change 
the original of the read data after completion of the locked 
read but before its presentation to the user. There is no 
guarantee that what the user sees will be the actual state of 
the target system. In short, conventional debugging servers 
or agents cannot insure that data presented to the user is 
15 accurate and sometimes cannot insure that data presented is 
internally consistent. 

It is preferable to use Gophers performing locking 
reads to upload data structures associated with system 

Qbjects . This method insures at least the internal 

20 consistency of important objects. 

Recognizing that data reads to satisfy user requests 
may not produce consistent or accurate data, a system 
incorporating an embodiment of the invention maintains a 
variable memory register 230 holding a threshold age. Under 
2 5 certain conditions described below, the system avoids 
consuming bandwidth with data reads. 

Figure 2 illustrates a host/target system 220 with a 
host-resident cache 210. The host software 140 satisfies data 
requests from the cache 210 if the data in the cache 210 is 
30 younger than the threshold age. if the threshold age is some 
predetermined value, such as zero, the server 14 0 always 
satisfies data requests by reference to the agent 110. 
Preferably, the user chooses the threshold age for the 
particular situation. Experiential data suggests that a 
35 threshold age of one second suffices for day-to-day 
situations . 

In another embodiment, the server maintains 
individual age thresholds for respective blocks of data in the 
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host cache. Accordingly, data known or deemed to be volatile 
can be refreshed at a greater rate than data known or deemed 
to be more static. In both of these embodiments, the 
flexibility is in the hands of the user. 

Another issue associated with caching is writing 
back: modifying the original when the copy has been modified. 
The debugging server cache 210 disclosed herein is 
"write-through," the data on the target 120 is updated 
essentially immediately after the copy on the host 150 is 
modified. The justification here is that the user always 
intends to modify the data actually on the target. Indeed, 
the user may not even be aware that the host software is 
performing any caching. 

In certain circumstances, the required writing back 
15 can be significantly streamlined. When the original data in 
the target memory is unchanging (and, therefore, consistent 
with the host copy) , only the writing back of the changed 
portions of the data is necessary, rather than writing back 

__^j^_^"^^'^^^y °^ cache d dat a. Thus^ where ^ache blocks 

are, say, a kilobyte in size and the change af fects~on'ly~tens ~ 
or small hundreds of sequential bytes, an advantage lies in 
instructing the debugging agent 110 to modify the affected 
tens or hundreds of bytes rather than instructing the agent 
110 to re-write the entire kilobyte. 

Another example is the reloading of a software 
application or module. Usually, when an application is 
changed to remedy some bug, only a small percentage of the 
application text changes (to add or delete a few lines of 
code) when re-compiled. Yet in the prior art, when this 
application is loaded onto the target, the loading consumes 
bandwidth as necessary to transfer the entire file. However, 
the invention views the application as a stream of data and 
the typical recompilation as the insertion and/or deletion of 
a small portion of the stream. When downloading a new stream 
of memory to the target 120, the stream is compared with the 
copy of the original target contents cached on the host 150, 
and the target 120 is instructed to adjust its memory to slip 
contents forward or backward to agree with the new module 
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being constructed. The host 150 then transfers new data, if 
any, to the target 120 to fill the newly vacant or other 
memory spaces. 

Relocation fields within the stream of data 
5 complicate the algorithm because they will almost always 

differ. However, the list of locations of the fields for both 
the original and the new stream of data are known beforehand. 
If the module is re-linked after transfer, these differences 
are inconsequential . 

10 

6. Host-Based Target Memorv Management 

In some cases, the development tools may require 
resources from the target in addition to those required by the 
application software on the target. These additional 

15 resources can be, for instance, sophisticated services which 
require exclusive access to an allocated portion of target 
memory. Among the most sophisticated of these memory-related 
services is dynamic memory management. 

Figure 3 is an abstract diagram of a host/ target 

20 system 3 00 and the respective memories 310 and 320. Systems 
embodying the invention take into account the fact that the 
memory 310 of the host system 150 is usually much larger than 
the memory 320 of the target system 120 and, therefore, the 
host system 150 can provide storage for many house-keeping 

25 data structures used in the management of the target-resident 
memory 320. With the intelligence (and code space) in the 
host 310 managing free lists of memory and other cumbersome 
data structures, the debugging agent 110 need only provide 
services such as move, copy and fill. 

30 The two data structures typically supporting a 

memory manager are a free memory list 330 and the allocated 
list (not shown) . (The latter is sometimes excluded for 
efficiency.) In one embodiment, the debugging server 140 will 
allocate host-based memory for these data structures and thus 

35 realize zero-overhead performance when allocating target 

memory. The free list 330 is a linked list of free blocks 
with each link in the list containing the address of the 
corresponding contiguous free block of memory on the target 
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and the size of this block. The list 330 is not ordered, and 
allocation is achieved with a traditional "first-fit" search 
of the list. The third data structure according to this 
embodiment is an AVL-tree or binary tree with nodes containing 
target memory block information sorted within the tree from 
lower target address to higher target address. This data 
structure is traversed whenever target memory is deallocated, 
in order to find the host-resident node that corresponds to 
the target block to be deallocated. The use of a b-tree 
limits the worst-case search to log N, where N is the number 
of allocated blocks in the tree. 

In prior art, the target debugging agent manages 
such data structures. By virtue of this invention, target 
systems incur less overhead in target memory allocation, thus 
15 saving resources for application use. Another virtue of this 
invention lies in that host-to-target protocol requests 
related to memory allocation are greatly reduced limiting the 
intrusion of host tool memory allocation on the real-time 
execution of a target system application. 

20 

7. Virtual I/Q 

Consider the scenario wherein the target no is a 
device-controlling processor. It has exactly two 
communications interfaces, one to receive input from a sensor 
25 and the second to control a device based on that input. The 

operations of the device affect the characteristic read by the 
sensor. The memory of the target is limited so that a 
target/host development environment is preferable or required. 
The question becomes how to connect the host when both 
communications ports are necessary for operation of the 
target. 

A system incorporating the invention maintains 
virtual I/O (VIO) channels. A VIO channel can be implemented 
as a pseudo-tty, a stream as in UNIX®, an underlying device, 
etc. The host 150 redirects communications intended for the 
controlled device to a communications channel of the host 
machine, to which communications channel the controlled device 
connected. The target machine is thus in communication 
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with the sensor, the controlled device and the host computer 
even though the target machine has only two communications 
interfaces. 

On the target lio, the operating system 130b 
supports a virtual I/O device driver 190 to provide target 
applications 130a with I/O system access to the virtual I/O 
facility according to the standard system call protocols of 
the target operating system 130b. in a UNIX® - or Posix-like 
operating system, a first open of a VIO channel is as follows: 

/* initialize virtual l/o driver */ 

/* this routine should only be called once */ 



if (VIO_DRIVER_STATE 1= OK) 

return (ERROR) ; 
/* create virtual l/o channel 0 named "/vio" */ 
/* with a 512-byte read buffer */ 
/* and a 512-byte write buffer */ 

if (VIO_DEVICE_CREATE("/vio", 0, 512, 512) '= OK) 
return (ERROR) ; ' ' 



/* open a file on VIO channel 4 */ 
25 if ((fd = open("/vio/4", O RDWR, 0)) == ERROR) 

return (ERROR) ; ~ ' 

The host 150 associates a VIO channel with any one 
of a wide variety of devices, including displays, files, raw 
30 devices, streams, etc. A host application reserves a virtual 
I/O channel using a system call. As a VIO channel number is 
used by both the server and agent to determine the source or 
destination of particular data, the host and target 
applications must agree as to the channel number. The host 
application typically then redirects the reserved VIO channel 
to an actual device on the host, using a system call to 
control the VIO channel. Following is a code sample 
redirecting VIO channel 4 to a file: 



40 /* open host file */ 

if ((fd_host = open ("/tmp/testf ile" , o RDWR, O) 
== ERROR) - ' ' 

return (ERROR) 
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Any data which the debugging agent no reads from or writes to 
"/vio/4," i.e., VIO channel 4, the target server 140 will 
redirect from or to "/tmp/testf ile. " 

on the host side, the target server 140 implements 
the mechanics of VIO channels. The debugging server 140 
maintains the VIO channel pool, allocating free VIO channels 
and freeing VIO channels on request. As illustrated above, 
the target server 14 0 also redirects data as requested. 

illustrates some of the levels of software 
supporting an embodiment of a virtual I/O channel (from the 
target to the host) . The host 400 includes a virtual console 
410 in communication with the target server software 460 The 
target server 460 is in communication with the corresponding 
debugging agent software 420 residing on the target 440. Also 
on the target 440 is the virtual I/O device driver 430, which 
is preferably a part of the operating system residing on the 
target 440. Application software 450 makes the standard 
operating system calls (e.g., write() on a UNIX®-like 
operating system) to the virtual I/O device driver. m FIG 
4, the virtual I/o device driver 430 instructs the debugging 
agent to transfer a buffer containing "Hello world\n" to the 
debugging server, which then directs the display of the string 
in the Xterm window 4 50 on the host 400. 



8 • In-Circuit Emulaf-if>n 

Consider targets with severely limited hardware 
resources. Providing a meaningful low cost development 
environment for this class of targets has historically proven 

35 difficult to impossible. For example, consider a target 

without the critical resource of a communications channel to 
the host, typically an ethernet or serial communications 
device. With no means of communication between the target and 
the host, interacting with the target during development of an 

40 embedded application is apparently impossible. 
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The invention exploits the power of ROM emulators 
and in-circuit emulators in general in a development 
environment, connecting a host-based development environment 
to a target-resident debugging agent in a resource-constrained 
environment. The advantages of such an approach in so 
connecting a debugging agent to the host server are two-fold. 
First, the ROM emulation provides a full-featured debugging 
environment to those targets in which no such environment 
could have existed in prior art. 

Second, the intermediated communications device now 
provides the communications and off-loads from the target 
environment a significant portion of the debugging agent 
dedicated to communications. As mentioned above, the RAM of 
the target is often a critical resource. Any technique that 
15 reduces the footprint (i.e., storage requirements) on the 
target of the debugging environment is highly desirable, 
leaving more target RAM available for application needs.' 
Where a NetROM provides the communications, it reduces the 
role of the debugging agent and in turn effects considerable 
20 savings in target RAM. The local agent program code to manage 
communications with the host would otherwise occupy the now 
conserved RAM. 



9 . World-Wide Access 

An added benefit of the target/host configuration 
upon which the prior art has not capitalized is the 
realization that the host need not be in physical proximity to 
the target. Figure 5 illustrates a target 520 and a host 530 
connected by means of remote communications technology sio. 
With the use of a WAN, e.g., the global telephone system with 
modem interfaces or a satellite communications system, the 
host 530 and/or target 520 can be anywhere on earth or near 
space where a port 540 onto the WAN (e.g., a telephone or 
satellite link) is available. With other known remote 
communications technology 510, the host 530 and/or target 520 
can be anywhere that technology reaches. The communications 
technology 510 can be a switching network, allowing any host 
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530 With the address (e.g., telephone number) of the target 
modem to connect with the target 520. 

When viewed as a representative of the target on the 
host, a host-based target server can broker requests for 
5 virtually any site. The Internet, with its suite of 

applications tracking who's who and where they are, is an 
excellent example of the remote communications technology 5io. 
Its suite of remote services makes possible bringing up a 
shell, for example, on any target 520 with a known address. 
10 Further, a user can register a target server 530 globally, and 
an authenticated user can bring up any tool on the associated 
target 520 for the purpose of remote development, 
demonstration, technical support, etc. This paradigm of 
distributed World-Wide access to real-time execution platforms 
shifts the standard usage patterns of cross-development 
environments from one of single-user work environments to one 
of distributed development. 

In one embodiment, the invention provides on-line 
access to all registered target systems 520 via their target 
servers 530 by means of a centralized control, panel 160a (Fig. 
1) summarizing all available targets and all available tools. 

CONCmSTONT 

In using the above-disclosed methods and apparatus, 
the Assignee of this invention has succeeded in reducing the' 
size of its debugging agents by an order of magnitude over the 
prior art. Typical agents according to the invention herein 
are approximately 20 kilobytes (Kb). By comparison, prior art 
agents are around 330 to 340 Kb. Consequently, the debugging 
agents disclosed herein are capable of running in a much 
broader range of target computers, particularly in those with 
memory less than 300 Kb. 



20 



35 



Of course, where memory is not a constraint, the 
instant invention may be practiced with a single computer 
system running both the server and the agent. 
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WHAT IS CLAIMED IS: 



3 
4 



6 
7 
8 



1 1. A method for retrieving data from a first 

2 memory of a first processor, said method comprising: 
coupling said first processor to a second processor 

by a communications link, said second processor having a 
5 second memory; 

generating on said second processor a program in an 
interpreted language, said program for reading data from 
memory and for communicating said read data over said 
9 communications link; 

communicating said program from said second 
11 processor to said first processor; 

receiving said program on said first processor; 
interpreting said program on said first processor, 
14 thereby reading data from said first memory and 

communicating said read data from said first processor to 
said second processor over said communications link; and 

receiving said read data on said second processor 
and storing said read data in said second memory. 



12 
13 



15 
16 
17 
18 



^ 2. The method of claim l wherein said step of 

2 communicating comprises 

3 compressing said program and 

4 said step of receiving said program comprises 

5 decompressing said program. 

1 3. The method of claim l wherein said step of 

2 interpreting comprises 

3 compressing said read data and 

4 said step of receiving said read data comprises 

5 decompressing said read data. 

1 4. An apparatus for debugging an application 

2 program, said apparatus comprising: 

3 a first processor having a first memory, said memory 

4 containing said application program and an interpreter of 

5 a program language; 
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a user input device through which a user can 
communicate a demand to examine a portion of said first 

8 memory ; 

9 a communications link; and 
a second processor, coupled to said first processor 

by means of said communications link and coupled to said 
user input device, said second processor having a second 
memory containing a program adapted to, in response to 
said demand, generate a program in said interpreted 
program language, said generated program for reading said 
portion of said first memory and for communicating said 
read portion over said communications link to said second 
18 processor. 



10 

11 

12 

13 

14 

15 

16 

17 



10 
11 
12 
13 



^ . 5. A method for debugging an application prograni, 

2 said method comprising: 

coupling a first processor having a first memory to 
a second processor having a second memory by means of a 
5 communications link; 

coupling said second processor to a user input 
device on which a user can communicate a demand for a 

8 debugging service; 

9 running a debugging program and said application 
program in said first memory; 

modifying, in response to said demand, the program 
text of said debugging program, enabling said debugging 
program to support said debugging service. 



3 
4 
5 
6 
7 
8 
9 
10 



^ ^ 6. A system for debugging an application program, 

2 said system comprising: 

a first processor having a first memory, said memory 
containing said application program and a debugging 
program adapted to perform debugging services; 

a user input device on which a user communicates a 
demand for a debugging service; and 

a second processor, coupled to said first processor 
and coupled to said user input device, said second 
processor having a second memory, said second memory 
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11 containing a program adapted to interpret said demand and 

12 to modify the program text of said' debugging program to 

13 enable said debugging program to support said debugging 

14 service, 

1 7. The system of claim 6 wherein said program 

2 adapted to interpret is further adapted to communicate program 

3 code for performing said debugging service to said debugging 

4 program and said debugging program is adapted to bind said 

5 program code to itself and thereby become capable of 

6 performing said debugging service, 

1 8. The system of claim 6 wherein said debugging 

2 program is further adapted to unbind said program code from 

3 itself when said debugging service has not been accessed 

4 within a predetermined amount of time, 

1 9. A system for debugging an application program, 

2 said system comprising: 

3 a first processor having a first memory, said first 

4 memory containing a symbol table for a core, said core 

5 being the linkage of application code for said 

6 application program and debugger code for a program for 

7 debugging said application program; 

8 a second processor, coupled to said first processor, 

9 said second processor having a second memory containing a 

10 copy of said core uploaded from said first memory; and 

11 a user input device, coupled to said first 

12 processor, on which a user communicates a demand for a 

13 debugging service, said debugging service performed by 

14 executing said debugging code in said copy of said core. 

1 10, A method for debugging an application program, 

2 said method comprising: 

3 coupling a first computer having first memory to a 

4 second computer having second memory; 

5 linking together application code for said 

6 application program with debugger code for debugging said 
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7 application program, forming a core, said core having a 

8 symbol table; 

9 placing a copy of said core in said first memory and 
1° a copy of said symbol table in said second memory; 

11 interpreting a demand for a debugging service input 

^2 on a user input device coupled to said second processor; 

13 and 

performing said debugging service on said first 
15 processor by executing said debugger code. 

1 11. The method of claim 10 wherein before said step 

2 of performing is performed, the following steps are performed: 

3 checking said symbol table to determine whether code 

4 to perform said debugging service is already resident in 

5 said first memory; 

6 uploading code to perform said debugging service 

7 when said checking determines that code to perform said 

8 debugging service is not already resident in said first 
^ memory and modifying s aid symbol table to reflect the 

tact that code to perform said debugging service is 

11 resident in said first memory; and 

12 refraining from uploading code to execute said 

13 demand when said checking determines that code to perform 

14 said debugging service is already resident in said first 

15 memory. 

1 12 . A method for reading memory, said method 

2 comprising: 

3 coupling a first computer having first memory to a 

4 second computer having second memory by means of a 

5 communications link; 

6 running a program in said first memory, thereby 

7 modifying said first memory; 

8 receiving a first command at a first time on said 

9 second computer, the performance of said first command 
10 requiring the reading of a portion of said first memory; 

reading said portion of said first memory into said 

12 second memory; 
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13 receiving a second command at a second time on said 

14 second computer, the performance of said second command 

15 requiring the reading of said portion of said first 

16 memory; 

17 reading said portion of said first memory into said 

18 second memory when the difference between said second and 

19 first times is greater than a predetermined value, and 

20 refraining from reading said portion of said first memory 

21 into said second memory when said difference is not 

22 greater than said predetermined value. 

1 13- The method of claim 12 wherein said second step 

2 of reading further comprises 

3 in any event, reading said portion of said first 

4 memory into said second memory when said predetermined 

5 value equals a second predetermined value. 

1 14. The method of claim 12 wherein said second step 

2 of reading further comprises 

3 in any. event, reading said portion of said first 

4 memory into said second memory when said portion of 

5 memory is associated with a system object. 

1 15. The method of claim 12 wherein before said 

2 second step of reading is performed, the following step is 

3 performed: 

4 setting said predetermined value in response to a 

5 command on a user input device. 

1 16. A system for inspecting memory, said system 

2 comprising: 

3 an inter-processor communications link; 

4 a first processor having first memory, a program 

5 running in said first memory and modifying said first 

6 memory ; 

7 an input device for receiving commands from a user; 

8 and 
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9 a second processor, coupled to said first processor 

10 by means of said inter-processor communications link and 

11 coupled to said input device, said second processor 

12 having 

13 second memory; 

1^ a register holding a time quantum; 

15 an arithmetic logic unit; and 

a CPU under program control, said program 

1'7 adapted to receive a first command at a first 

18 time by means of said input device, the 

1^ performance of said first command requiring the 

20 reading of a portion of said first memory; to 

21 read said portion of said first memory into 

22 said second memory; to receive a second command 

23 at a second time by means of said input device, 

24 the performance of said second command 

25 requiring the reading of said portion of said 

26 first memory; to read said portion of said 

2*7 first memory into said second memory when the 

28 difference between said second and first times 

2^ is greater than a predetermined value; and to 

^0 refrain from reading said portion of said first 

31 memory into said second memory when said 

32 difference is not greater than said 

33 predetermined value* 

1 17. A method for modifying memory, said method 

2 comprising: 

3 coupling a first processor having first memory to a 

4 second processor having second memory by means of a 

5 communications link; 

6 downloading a copy of first data from said first 

7 memory to said second memory; 

8 generating second data in said second memory; 

9 generating a script for modifying said first data to 
10 produce said second data; 

^1 transmitting said script to said first processor; 
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^2 executing said script, modifying said first data to 

13 produce a copy of said second data in said first memory, 

1 18. The method of claim 17 wherein said step of 

2 executing comprises 

3 moving a portion of said first data from a first 

4 area in said first memory; 

5 copying a portion of said second data to said first 

6 area, 

1 19. The method of claim 17 wherein said step of 

2 executing comprises 

3 overwriting a first portion of said first data with 

4 a second portion of said first data; 

5 copying a portion of said second data to said first 

6 memory . 

1 20. The method of claim 17, further comprising the 

2 step of 

3 re-linking said copy of said second data in said 

4 first memory. 

1 21. A system for managing the memory of a 

2 processor, said system comprising: 

3 said processor having said memory; 

4 a first application in said memory; 

5 a second application in said memory, said second 

6 application adapted to develop said first application, 

7 said second application adapted to reserve free space 

8 from said memory and requiring memory management services 

9 for said free space; 

10 a communications link; 

3 second processor, coupled to said processor by 

^2 means of said communications link, said second processor 

13 having second memory; and 

3 third application in said second memory, said 
third application adapted to provide said memory 
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16 manageinent services for said free space over said 

17 communications link. 

1 22. A method for managing the memory of a 

2 processor, said method comprising: 

3 coupling said processor to a second processor by 

4 means of a communications link, said second processor 

5 having second memory; 

6 running a first application in said memory; 

7 running a second applications in said memory which 

8 reserves free memory, said second application for 

9 developing said first application, said second 

^0 application requiring memory management services for said 

11 free memory; 

^2 running a third application in said second memory, 

1^ said third application adapted to provide memory 

14 management services over said communications link; 

requesting memory management services of said second 
processor, thereby generating instructions for said first 

17 processor; 

^® managing the free memory of said first processor in 

19 response to said instructions. 

1 23. An apparatus for analyzing a 

2 processor-controlled system, said apparatus comprising: 

3 an external device adapted to be controlled by a 

4 processor; 

5 a first processor having memory, said first 

6 processor adapted for coupling to said external device, 

7 said first processor having exactly the number of 

8 communications channels necessary for said first 

9 processor to operate in final configuration including 

10 running an application in said memory, thereby 

11 controlling said external device; and 

12 3 second processor having second memory, said second 

13 processor coupled to said first processor by means of one 
1^ of said number of communication channels and coupled to 
1^ said external device by means of a communication channel, 
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said second processor running a second application in 
said second memory, said second application adapted to 
develop said first application, including communicating 
data to said external device, said data controlling said 
external device, said data received over said one of said 
number of communications channels and communicated over 
22 said communications channel. 

1 24. A method for analyzing a processor-controlled 

2 system, said method comprising: 

3 coupling a first processor to a second processor by 

4 means of a first communications channel; 
coupling an external device to said second processor 

by means of a second communications channel, said 
external device adapted to be controlled by said first 
processor by means of said first communications channel; 
generating data to control said external device; 
communicating said data from said first processor to 
^^^^ second processor over said first communications 
12 channel; 

receiving said data in said second processor and 
communicating said data via said second communications 
15 channel to said external device; and 

sending second data to analyze said first processor 

17 between said first and second processors via said first 

18 communications channel. 

1 25. An apparatus for analyzing a 

2 processor-controlled systems, said apparatus comprising: 

3 a plurality of processor-controlled systems 

4 interconnected by means of a network; 

5 a registry, coupled to said network, said registry 

6 adapted to register processor-controlled systems; 

7 a processor, coupled to said network and registered 

8 with said registry, said processor having a user input 

9 device, adapted to receive a command on said user input 
10 device and adapted to establish a communication channel 



5 

6 
7 
8 
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"i^^ 3 Of said plurality of processor-controlled 

12 systems specified in said command. 

1 2 6. In a target /host computer system, an agent 

2 having a size less than 300 kilobytes (Kb). 

1 27. The computer system of claim 26 wherein said 

2 agent has a size less than 200 Kb. 

1 28. The computer system of claim 26 wherein said 

2 agent has a size less than 100 Kb. 

1 29. The computer system of claim 26 wherein said 

2 debugging agent has a size of about 20 Kb. 

1 30. A method for debugging a software program under 

2 test, said method comprising the steps of: 

3 executing on a first processor development software 

4 having an interface; 

loading said software program under test in the 
memory of a second processor having a receptacle for 
receiving hardware capable of being read or written ; 
executing software for examining said software 
9 program under test on said second processor; 

10 placing an emulator of said hardware in said 

11 receptacle; and 

12 communicating between said first and second 
processors by means of said emulator. 

1 31. The method of claim 3 0 wherein said step of 

2 communicating comprises 

communicating between said first and second 
processors by means of said interface and said software 
for examining said software program under test. 



5 
6 
7 
8 



1 32. A system for debugging a software program under 

2 test, said system comprising: 
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3 a first processor having a memory wherein is located 

4 development software having an interface; 

5 a second processor having 

6 a receptacle for receiving hardware 

capable of being read or written and 

a memory wherein is located said software 
program under test and software for examining 
said software program under test; and 
an emulator of said hardware, located in said 
receptacle and communicatively coupling said first and 



13 second processors. 

1 33. The system of claim 32 wherein said emulator 

2 comprises 
3 
4 



an emulator communicatively coupling said 
development software and first and said software for 



5 examining. 
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